home *** CD-ROM | disk | FTP | other *** search
/ Software Vault: The Gold Collection / Software Vault - The Gold Collection (American Databankers) (1993).ISO / cdr36 / cl30beta.zip / CLASSIFY.DOC < prev    next >
Text File  |  1993-05-06  |  41KB  |  908 lines
  1.  
  2.  
  3.  
  4.  
  5.  
  6.  
  7.  
  8.  
  9.  
  10.                              CLASSIFIED ADS
  11.  
  12.                                   v3.0
  13.  
  14.                                    by
  15.  
  16.                               Al Lawrence
  17.  
  18.                             Sunrise-80  BBS
  19.                     (404) 256-9525 (19.2 HST DS v.32)
  20.                     (404) 705-9104 (14.4 v.32bis)
  21.                             FIDO 1:133/410
  22.  
  23.  
  24.  
  25.  
  26.                  Copyright  1992 - 1993,   Al Lawrence
  27.                           All Rights Reserved
  28.  
  29.  
  30.                           Table of Contents
  31.                           -----------------
  32.  
  33.     Overview.......................................................... 1
  34.     Installation...................................................... 2
  35.     Configuration File Description.................................... 3
  36.     Restrictions...................................................... 4
  37.     Modify an Ad...................................................... 4
  38.     Download Ads...................................................... 4
  39.     Reading Ads Offline............................................... 5
  40.     Topics File (CLTOPICS)............................................ 6
  41.     Category File..................................................... 7
  42.     Welcome and Goodbye Files......................................... 8
  43.     'Pay to Advertise'................................................ 9
  44.     Purging Ads, Messages............................................. 10
  45.     Database Exchange................................................. 11
  46.     Setting up a Hub to Exchange files................................ 13
  47.     Non-Standard COM Support.......................................... 15
  48.     Multi-Node Setup.................................................. 16
  49.     File Transfer Protocols (PROTOCOL.DAT)............................ 17
  50.     File Compression (COMPRESS.DAT)................................... 18
  51.     Limiting Exports by Category (CLEXPORT.DAT)....................... 19
  52.     Maintenance Program (CLMAINT)..................................... 20
  53.     PrePaid Ads....................................................... 21
  54.     Legalities........................................................ 22
  55.     Distribution...................................................... 22
  56.     Registration...................................................... 22
  57.     Misc.............................................................. 23
  58.  
  59.                                                                        Page 1
  60.                                 OVERVIEW
  61.                                 ________
  62.  
  63.  
  64.    The CLASSIFIED Ads Door is designed to allow callers to post Classified Ads
  65.    in any of the unlimited categories you have set up. You can designate each
  66.    category to be "FREE" or "PAY". "PAY" categories give you the option of
  67.    charging businesses/individuals for posting their ads; similar to your
  68.    local newspapers.
  69.  
  70.  
  71.  
  72.    NOTE: Most errors will be logged to a file called DFRAME.ERR which is
  73.          created in the Classified Door directory.
  74.  
  75.  
  76.  
  77.                                                                        Page 2
  78.                               INSTALLATION
  79.                               ____________
  80.  
  81.  
  82.    Installation is fairly easy and straight-forward. The following steps and
  83.    examples should have you up and running in a very short period of time.
  84.    It is assumed that you are familiar with setting up DOORS on your system.
  85.    To this end, only examples of the configuration file and Door batch file
  86.    (if required by your BBS software) are described.
  87.  
  88.       1) Create a directory to hold all CLASSIFY files
  89.  
  90.       2) Unzip CLASFYxx.ZIP into the the above directory
  91.  
  92.       3) Create a configuration file, with a name of your choice, or modify
  93.          the supplied CLASSIFY.CFG file. You can do this manually with an editor
  94.          of your choice OR you can use the configuration option in the
  95.          Classified Ads Maintnenance program (CLMAINT). The configuration file
  96.          layout/description can be found further on in this document
  97.  
  98.       4) Create a batch file or modify the CLASSIFY file supplied (if your BBS
  99.          software requires the use of a batch file to execute the door). A
  100.          description of this file follows:
  101.  
  102.             ECHO off
  103.             cd\BBS\DOORS\CLASSIFY     Location of CLASSIFY files
  104.             CLASSIFY CLASSIFY.CFG     EXE filename and CFG filename (Name
  105.                                       used in creating file in #3 above)
  106.             CD\BBS
  107.             BOARD
  108.  
  109.  
  110.        5) When running more than one node, read MULTI-NODE SETUP further on
  111.           in this document.
  112.  
  113.  
  114.        6) Unzip CLBATCH.ZIP, which contains working batch files examples for
  115.           some popular protocols.
  116.  
  117.                                                                        Page 3
  118.                         CLASSIFIED ADS CONFIGURATION FILE
  119.  
  120.    **                       Location of system file (See Below)
  121.    SUNRISE-80 BBS           Your BBS Name
  122.    Al                       Sysop's First name
  123.    Lawrence                 Sysop's Last Name
  124. |-----------------------------------------------------------------------------|
  125. | READ!     1                        CommPort  \ These 2 lines are required   |
  126. | READ!     1                        Node #    / ONLY for GTUSER.BBS          |
  127. |-----------------------------------------------------------------------------|
  128.    00000000                 Registration Number
  129.  # 2                        Keyboard timeout value in Minutes
  130.  # NONE                     Drive:\Path\Filename to contain the Bulletin
  131.                             summarizing all Ads in the database
  132.  
  133.    Y                        Y=Display the Originating BBS Name, N = Do NOT
  134.  
  135.    N                        Y =  Use European Date Format (DDMMYY)
  136.                             N =  Use Regular  Date Format (MMDDYY)
  137.  
  138.    0                        Minimum Logon Security Level required to use the new
  139.                             AD option. Zero(0) will allow access to everyone.
  140.  
  141.    0                        Minimum Logon Security Level required to use the
  142.                             DELETE option. Zero(0) will allow access to everyone
  143.  
  144.    0                        Minimum Logon Security Level required to use the
  145.                             MODIFY option. Zero(0) will allow access to everyone
  146.  
  147.    0                        Minimum Logon Security Level required to use the
  148.                             MESSAGES option. Zero(0) allows access to everyone.
  149.  
  150.    00000000                 Ads Exchange Program Registration Number
  151.  
  152.    SUN80                    Name of the EXPORT file that is generated by the
  153.                             CLEXCH program. We suggest that it be a unique name.
  154.                             DO NOT include an extension! Maximum of 6 characters
  155.  
  156.    WELCOME                  Name of the WELCOME file. CAN contain an extension.
  157.  
  158.    GOODBYE                  Name of the GOODBYE file. CAN contain an extension.
  159.  
  160.    (Any Info You Wish)      Additional information about your BBS, that will be
  161.                             displayed with each Ad posted on your BBS. We
  162.                             suggest the use of the BBS telephone # as it is
  163.                             displayed adjacent to the Originating BBS Name.
  164.                             MAXIMUM of 25 characters.
  165.  
  166.    SYSOP                    BBS name the SYSOP uses when he/she logs on. When a
  167.                             caller enters an Ad in a PAY category, a message is
  168.                             sent to THIS name to notify the Sysop about the Ad.
  169.  
  170.    Y                        Y = Allow Downloading, N = NO Downloading
  171.  
  172. ** = Replace with a PATH to ONE of the following:
  173.    PCBOARD.SYS    CALLINFO.BBS   USERINFO.DAT    DOOR.SYS   GTUSER.BBS
  174.    DORINFOx.DEF   SFDOORS.DAT    CHAIN.TXT
  175.  
  176.   # = Requires registration to change to a different value.
  177.  
  178.                                                                        Page 4
  179.                             RESTRICTIONS!
  180.                             -------------
  181.  
  182.    UnRegistered versions of CLASSIFIED Ads have the following restrictions:
  183.  
  184.           . Maximum of 15 Messages may be entered
  185.           . Maximum of 20 Ads may be entered
  186.           . Purge option is disabled
  187.           . WELCOME file is not recognized
  188.           . GOODBYE file is not recognized
  189.           . Keyboard timeout value remains at 2 minutes
  190.           . Bulletin will not be generated
  191.           . Unable to Export Ads and Messages
  192.  
  193.  
  194.  
  195.  
  196.  
  197.  
  198.                            MODIFYING an AD
  199.                            ---------------
  200.  
  201.    All Ads may be modified by the caller that entered the Ad or the Sysop of
  202.    BBS on which the Ad was entered. If you, as the Sysop, try to modify an Ad
  203.    that was not entered on your BBS, the program will revert back to the Main
  204.    Menu.
  205.  
  206.  
  207.  
  208.  
  209.  
  210.                            DOWNLOADING  ADS
  211.                            ----------------
  212.  
  213.    Callers may download Ads by choosing the appropriate option from the main
  214.    menu. Downloading is OPTIONAL and is controled via an option in the
  215.    configuraiton file. Therefore, if you decide not to allow your callers to
  216.    download, you may set the appropriate option to "N" in the configuration
  217.    file. If you do permit downloading, you MUST define the protocols and
  218.    compression formats you will be supporting on your board. (See Compression
  219.    Formats and File Transfer Protocols in this document).
  220.  
  221.  
  222.                                                                        Page 5
  223.                         READING DOWNLOADED ADS OFFLINE
  224.                         ------------------------------
  225.  
  226.    Your callers have the ability to download the Ads database and read them
  227.    offline. They must use the reader supplied with the Classified Ads Door,
  228.    called CLREADER.
  229.  
  230.    Optionally, the caller can send a message to the Ad poster and upload the
  231.    message(s) to the Classified Ads door, on a subsequent call.
  232.  
  233.    There is an option on the Main Menu that will allow your callers to Download
  234.    the CLREADER.EXE and CLREADER.DOC files. You must ensure that both files
  235.    exist in the Classified Ads Directory. The files MUST NOT be compressed
  236.    (ZIPed, etc) as the caller will be given the option to choose one of the
  237.    compression routines you have defined for use with Classified Ads.
  238.  
  239.  
  240.                                                                        Page 6
  241.                                TOPICS File (CLTOPICS)
  242.                                ----------------------
  243.  
  244.    Classified Ads allows you to define an unlimited number of Categories into
  245.    which callers enter their Ads. Although this provides your callers with a
  246.    wide variety from which to choose, it takes a long time to display these
  247.    Categories on the screen (especially at lower modem speeds).
  248.  
  249.    To this end we have taken the approach that we will consolidate categories
  250.    into TOPICS and allow the caller to choose from a maximum of 30 TOPICS. As
  251.    each TOPIC is chosen we display ONLY those Categories that YOU have
  252.    associated with that TOPIC.
  253.  
  254.    If you DO NOT want to present TOPICS to your callers (yes it is optional...)
  255.    don't create the CLTOPICS file and they will be presented with the Categories
  256.    directly. OR create an ASCII file called CLTOPICS and define each topic on a
  257.    separate line, EXACTLY as you want it displayed to the caller. Each line
  258.    can have a maximum of 35 characters and a maximum of 30 TOPICS.
  259.  
  260.    Categories are defined in the CLASSIFY.CAT file. One of the entries for
  261.    each Category is the TOPICS number. This number corresponds to the line
  262.    number within the TOPICS file you wish to link to this Category. See
  263.    CATEGORY FILE discussion elsewhere in the documentation.
  264.  
  265.  
  266.  
  267.  
  268.                                                                        Page 7
  269.                         CATEGORY FILE (Classify.CAT)
  270.                         ----------------------------
  271.  
  272.        Be sure to give a lot of thought to your choice of categories, since
  273.        the category position in this file is carried in each Ad record. This
  274.        means, if you set up the categories so that #2 was 'Want Ads - General'
  275.        and the caller entered an Ad under that category, the Ad would carry
  276.        category #2 as the category number. If you then decide that you want to
  277.        change the 'Want Ad - General' category to say, 'Announcements', then
  278.        the Ads carrying #2 in their record would be classified incorrectly.
  279.  
  280.                The format of the Classify.Cat file follows:
  281.  
  282.                             TT,UUUUUUUU,VV,W,X,Y,Z
  283.  
  284.                Where t = Topic number from TOPICS file or 0 if you have
  285.                          chosen not to use TOPICS
  286.                      u = Category name. Max length: 25 characters(NO COMMAS)
  287.                      v = Maximum number of days a "FREE" ad can remain active.
  288.                          Min:1 Max 365 (This value is not used with "PAY"
  289.                          categories). Each "FREE" ad carries a purge date
  290.                          calculated by adding this value to the date the Ad
  291.                          was entered.
  292.                      w = Should the program ask for COST ($$$) info. You
  293.                          would answer Y for a For Sale type category and
  294.                          an N for a WANT AD or Announcment type category.
  295.                      x = Category security level. If caller's logon security
  296.                          level is less than this security level, they will not
  297.                          be able to enter or view an ad in this category. A
  298.                          category security level of 0 allows anyone access.
  299.                      y = Allow Ads to be downloaded from this conference.
  300.                          Y=yes, N=no
  301.                      z = 'Pay' Category.   P = Pay   F = Free
  302.  
  303.    The Classified Ads Door will check each category entry and will report
  304.    any errors it detects. Error numbers are defined as follows:
  305.  
  306.                1 = Category Name greater than 25
  307.                2 = Days to remain active is less than 0 or greater than 365
  308.                3 = COST field contains other than a Y or N
  309.                4 = Allow downloads field contains other than a Y or N
  310.                5 = PAY field contains other than a P or F
  311.                6 = The topic number is greater than the actual number of
  312.                    topics in the CLTOPICS file OR the CLTOPICS file was
  313.                    not found in the Classify directory.
  314.  
  315.                                                                        Page 8
  316.                         WELCOME and GOODBYE Files
  317.                         -------------------------
  318.       The following applies to registered versions of CLASSIFY ONLY!
  319.  
  320.       You can define the name of the WELCOME file in the configuration file.
  321.       If the program finds that filename, it will display that file after
  322.       the opening screen and before the main menu screens. The file must
  323.       reside in the same directory as CLASSIFY.EXE
  324.  
  325.       You can define the name of the GOODBYE file in the configuration file.
  326.       If the program finds that filename, it will display that file when the
  327.       caller exits the program. It will display prior to displaying the file
  328.       called ADOPT.SYS (if you have created it). The file must reside in the
  329.       same directory as CLASSIFY.EXE
  330.  
  331.  
  332.                                                                        Page 9
  333.                        "PAY-TO-ADVERTISE" Option
  334.                         ________________________
  335.  
  336.       Classified Ads can be used to charge for the placement of an
  337.       advertisement and/or allow for the ads to be placed free of charge. You
  338.       decide which on a category-by-category basis.
  339.  
  340.       You make a category a 'PAY' category by changing the appropriate entry
  341.       in the Classify.Cat file from an "F" to a "P".
  342.  
  343.       You have the option to create an ASCII file that will be displayed to
  344.       the caller, everytime they choose a particular 'PAY' category in which
  345.       to enter an ad. This file can contain any pertinant information such
  346.       as the method of payment, information required, etc. If you want the
  347.       same file to be used for ALL 'PAY' categories, then you must name the
  348.       file "PAY" (no quotes). If you want to display a unique file for some
  349.       'PAY' categories, then you must name the file  "PAYx", where x is the
  350.       line number of the corresponding entry in the ClASSIFY.CAT filer. If
  351.       the program does not find a 'PAYx" for a particular 'PAY' category, it
  352.       will then search for a "PAY" file. If neither is found it will not
  353.       display anything. We strongly suggest that you create a file for display
  354.       for all 'PAY' categories so as to ensure that the callers understand the
  355.       guidelines you have established for 'PAY' categories.
  356.  
  357.       Any ads entered into a 'PAY' category, will remain INVISIBLE to everyone
  358.       until payment is received and the Sysop makes that ad VISIBLE. You must
  359.       use the appropriate option in the Classified Ads Maintenance program
  360.       (CLMAINT) to make an ad VISIBILE. Please note that INVISIBLE ads are NOT
  361.       exported!
  362.  
  363.       The  maintenance program (CLMAINT.EXE) will display EVERY ad in the
  364.       database that is flagged as INVISIBLE. You will have the choice of
  365.       BYPASSING it, DELETING it or making it VISIBLE. Once an ad is deleted or
  366.       made VISIBLE, it can not be reversed... so BE CAREFUL!
  367.  
  368.  
  369.  
  370.                                                                        Page 10
  371.                            AUTOMATED PURGING
  372.                            -----------------
  373.  
  374.       When you set up the categories to be used in your version of CLASSIFIEDS,
  375.       you are asked to define the number of days the ad should remain active.
  376.       By running the CLMAINT (PURGE option) program in your nightly event
  377.       process you will ensure that the ads are deleted, automatically.
  378.  
  379.       In addition to purging expired ads, the CLMAINT Purge option will pack
  380.       the message database
  381.  
  382.       The following is all that is required to execute the purge:
  383.  
  384.                          CLMAINT CLASSIFY.CFG /EVENT
  385.                                  ^^^^^^^^^^^^
  386.                                      |
  387.                                      |------ or your congfiguration file name
  388.  
  389.           Note: This is only available in registered versions!
  390.  
  391.  
  392.   
  393.                                                                        Page 11
  394.                            DATABASE EXCHANGE
  395.                            _________________
  396.  
  397.   ** A GREAT WAY TO SHARE THE CLASSIFIED ADS DATABASE BETWEEN 2 OR MORE BBS' **
  398.      ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
  399.       The optional Classified Ads Database Exchange feature will allow you
  400.       to participate in the exchange of Classified Ads databases (Ads and
  401.       Messages) BBS' (Any number of BBS' can participate). The exchange
  402.       program is named CLEXCH and comes included in the CLASFYxx.ZIP file.
  403.  
  404.       CLEXCH performs three (3) major functions:
  405.  
  406.      (1) EXPORT:  Extracts all active ads and messages from the Classified
  407.                   databases. It creates files named XXXXXXrr.AXP and
  408.                   XXXXXXrr.MXP (XXXXXX is defined in the CFG file, rr is a
  409.                   random letter/number combination) and will bypass any
  410.                   ad already flagged for deletion as well as those Ads that
  411.                   were previously exported.
  412.  
  413.      (2) IMPORT:  Imports files named XXXXXXrr.AXP and XXXXXXrr.MXP and
  414.                   XXXXXXrr.MXP (XXXXXX is defined in the CFG file, rr is a
  415.                   random letter/number combination) created by the EXPORT
  416.                   option and merges all ads and messages into the Classified
  417.                   databases. It will not import any ads or messages that
  418.                   duplicates ads or messages found in the existing databases.
  419.                   Note that this option will IMPORT ALL files with an extension
  420.                   of AXP and MXP, during a single execution of the program.
  421.  
  422.      (3) IMPEXP:  This option will first IMPORT (as in (2) above) then turn
  423.                   around and EXPORT (as in (1) above) during one execcution
  424.                   of the program.
  425.  
  426.      All BBS' involved in the exchange MUST run registered versions of BOTH
  427.      Classified Ads and Classified Exchange (CLEXCH).
  428.  
  429.      It is critical that ALL participants in the exchange use the SAME
  430.      Category file. Failure to do so will result in ads meant for a certain
  431.      category on one system, showing up in a category totally unrelated on
  432.      another system.
  433.  
  434.  
  435.  
  436.       N O T E:  To EXCLUDE certain categories from breing exported see
  437.                 "Limiting Export by Category" elsewhere in this document
  438.  
  439.  
  440.  
  441.  
  442.                             (Continued on Next Page)
  443.  
  444.  
  445.                                                                        Page 12
  446.                         DATABASE EXCHANGE (Continued)
  447.  
  448.  
  449.      To run the Exchange you do the following:
  450.  
  451.      EXPORT:  a) Change to the directory containing your CLASSIFY.DAT file
  452.               b) Issue this command:  CLEXCH EXPORT CLASSIFY.CFG
  453.                  If you use a different name for your Config file, then
  454.                  substitute that name for CLASSIFY.CFG
  455.               c) Send (transmit) ALL *.AXP and *.MXP files to those involved
  456.                  in the exchange or to the HUB.
  457.               d) Delete ALL .AXP and .MXP files
  458.  
  459.      IMPORT:  a) Change to the directory containing your CLASSIFY.DAT file
  460.               b) Copy the *.AXP and *.MXP files that were sent to you by the
  461.                  BBS you are exchanging with, to the directory used
  462.                  in item (a) above.
  463.               c) Issue the command:   CLEXCH IMPORT CLASSIFY.CFG
  464.                  If you use a different name for your Config file, then
  465.                  substitute that name for CLASSIFY.CFG
  466.               d) Delete ALL *.AXP and *.MXP files
  467.  
  468.      IMPEXP:  a) Change to the directory containing your CLASSIFY.DAT file
  469.               b) Copy the *.AXP and *.MXP files that were sent to you by the
  470.                  BBS you are exchanging with, to the directory used
  471.                  in item (a) above.
  472.               c) Issue the command:   CLEXCH IMPEXP CLASSIFY.CFG
  473.                  If you use a different name for your Config file, then
  474.                  substitute that name for CLASSIFY.CFG
  475.               d) Send (transmit) ALL *.AXP and *.MXP files to those involved
  476.                  in the exchange or to the HUB.
  477.  
  478.    NOTE: When registering CLEXCH, you MUST use the EXACT SAME Sysop Name
  479.          AND BBS NAME as used for CLASSIFIED ADS!!!!!!!!!!!!!!!!!!!!!!!!!
  480.  
  481.    NOTE: All IMPORT and EXPORT transactions are now recorded in a
  482.          file called CLEXCH.LOG. If the file exists it will append
  483.          the information, if not it will create the file and add
  484.          the information. Thus you are free to delete it at any time.
  485.  
  486.  
  487.                                                                        Page 13
  488.          HOW TO SETUP AS A HUB AND DO CLASSIFIED ADS EXCHANGES
  489.          -----------------------------------------------------
  490.  
  491. Below, is a fully working batch file complete with comments, for the group
  492. hub. There are a few very important things to remember in running the
  493. Classified Ads as a hub.
  494.  
  495. FIRST, make sure all your nodes have the same categories or mass confusion
  496. will result. SECOND, it is highly advisable that you and your nodes use a
  497. unique name (representative of your board) instead of the generic
  498. "Classify.exp", for example Sun.exp would be the name for Sunrise BBS.
  499. THIRD, this batch file (Exchange.bat) is best run during your event each
  500. night, rather than each time the door is executed, especially if you are
  501. connected to boards that are long distance. The commands for your nightly
  502. event batch file would be:
  503.  
  504. CD\CLASSIFY
  505.    CLPURGE CLASSIFY.CFG
  506.    CALL EXCHANGE.BAT
  507.    DEL CLASSIFY.EXP
  508. CD\
  509.  
  510. Exchange.bat would be located in your classified directory and would be the
  511. batch file listed below. You may feel free to remove the comments and use
  512. the batch file below after modification for your system drive/path/name
  513. specifications.
  514.  
  515.  
  516.  
  517.  
  518.  
  519.                      (Continued on Next Page)
  520.  
  521.  
  522.                                                                        Page 14
  523.  
  524.                        HUB SETUP (Continued)
  525.  
  526.  
  527. _______________________________________________________________________________
  528. BATCH FILE EXAMPLE FOR THE HUB USING THE CLASSIFIED ADS EXCHANGE PROGRAM
  529.  
  530.  
  531.  
  532. @echo off
  533. del I:\db\files\classify.exp
  534.     ^  ^^ ^^^^^
  535. Comment: Above would be the drive/path to your inbound/outbound files directory.
  536.          This command will delete your previous night's export. NOTE: DO NOT
  537.          use this command the first night you start the import/export with
  538.          other boards.
  539.  
  540. cd\db\files
  541.    copy *.exp I:\ra\doors\classify
  542.         ^^^^^
  543.    del *.exp
  544.        ^^^^^
  545.  
  546. Comment: Copy all exported files sent to you into your classified directory,
  547.          then delete all the exported files. FAILURE to use a unique .exp
  548.          name will result in files over writing and only the last .exp file
  549.          copied will be imported into your database.
  550.  
  551. cd\ra\doors\classify
  552.    clexch IMPEXP classify.cfg
  553.                  ^^^^^^^^^^^^
  554.    copy classify.exp i:\db\files
  555.         ^^^^^^^^^^^^    ^^ ^^^^^
  556.  
  557. Comment: Perform the import/export (IMPEXP) then copy the resulting export file
  558.          from your classify directory to your outbound files directory.
  559.  
  560. cd\db
  561.    dbutil i send 1:114/203 i:\db\files\classify.exp
  562.    ^^^^^^
  563.  
  564. Comment: Send the export file to the other boards. Note above that the command
  565.          used is for D'Bridge...you may substitute the proper command and
  566.          outbound files directory for your front end mailer. You will need to
  567.          do an export for every BBS connected to you.
  568.  
  569.     __________________________________________________________
  570.    | This example provided to you courtesy of: Window In Time |
  571.    |                                           1:114/203      |
  572.    |                                           602-253-1946   |
  573.    |                                                          |
  574.    |  Feel free to contact the Sysop of Window In Time!!!!    |
  575.    |__________________________________________________________|
  576.  
  577.  
  578.  
  579.  
  580.                                                                        Page 15
  581.                         NON-STANDARD COM SUPPORT
  582.                         ________________________
  583.  
  584.       Support for COM 1-4 on the standard IRQ's - COM1/COM3 = IRQ4 and
  585.       COM2/COM4 = IRQ3. If you wish to use a non-standard IRQ, add the IRQ
  586.       number after the configuration filename. Let's assume your Door is
  587.       called FOOBAR and you want to use COM1 and IRQ5. The command line
  588.       passed to your Door would be:
  589.  
  590.                             FOOBAR FOOBAR.CFG /5
  591.  
  592.       The /5 tells FOOBAR to use IRQ5 rather than the standard IRQ4 that is
  593.       normally used with COM1. No /x parameter is needed for the standard
  594.       IRQ's.
  595.  
  596.       As an alternative, you may use an environmental variable on the command
  597.       line. To use the variable (following the example above), place a
  598.       SET IRQ=5 in the batch file used to bring up your BBS (you would need a
  599.       different IRQ number for each node). The command line would now look
  600.       like this:
  601.  
  602.                           FOOBAR FOOBAR.CFG /%IRQ%
  603.  
  604.       This, in combination with the use of the environmental variables
  605.       described in the MULTI-NODE SETUP section will allow you to use one
  606.       batch file and one config file to run this door on all nodes.
  607.  
  608.  
  609.  
  610.   
  611.                                                                        Page 16
  612.                            MULTI-NODE SETUP
  613.                            ________________
  614.  
  615.       All Sunrise Doors are Multi-Node capable. Each node must have the
  616.       ability to access a configuration file which will have its own system
  617.       file (DORINFOx.DEF, PCBOARD.SYS, DOOR.SYS, etc) defined on the first
  618.       line. There are 2 ways to accomplish this:
  619.  
  620.       (1) Create a separate configuration file for each node. The only
  621.           difference between each file would be the location of the system
  622.           file for that particular node. For example, on my system there are 2
  623.           nodes and the first line of the config files would look like this:
  624.  
  625.                         NODE1:  H:\PCB1\DOOR.SYS
  626.                         NODE2:  H:\PCB2\DOOR.SYS
  627.  
  628.           Thus, if you have a 4 node BBS, you will need 4 configuration files.
  629.  
  630.       (2) Use ONE configuration file for ALL nodes. This Door will recognize
  631.           the following PCBoard environmental variables:
  632.  
  633.                  PCBDIR    (Directory containing the System file)
  634.                  PCBDRIVE  (Drive containing the System file)
  635.  
  636.           Thus, the first line of the SINGLE configuration file, for this Door
  637.           would look like this:
  638.  
  639.                         %PCBDRIVE%%PCBDIR%\DOOR.SYS
  640.  
  641.       NOTE: This option, as described, assumes that you are running PCBoard
  642.             14.5a software. The environmental variables are automatically
  643.             created by the software for each node.
  644.  
  645.             HOWEVER, if you are running other BBS software you should be able
  646.             to set the variables EXACTLY as described below, for EACH node
  647.             (more than likely in each batch file you use to bring up EACH node):
  648.  
  649.                             PCBDRIVE=C:
  650.                             ^^^^^^^^^
  651.                             PCBDIR=\NODE2
  652.                             ^^^^^^^^
  653.  
  654.             Info with a carat (^) under it, MUST be typed as is. The rest
  655.             depends on your naming conventions.
  656.  
  657.             This, in combination with the use of the optional environmental
  658.             variable described in the NON-STANDARD COM SUPPORT section, will
  659.             allow you to use one batch file and one config file to run this
  660.             door on all nodes.
  661.  
  662.  
  663.  
  664.                                                                        Page 17
  665.                    UPLOAD/DOWNLOAD FILE TRANSFER PROTOCOLS
  666.                    ---------------------------------------
  667.  
  668.       Classified Ads externalizes all file transfer protocols used for Uploading
  669.       and Downloading of the Classified Ads. This allows the Sysop to define the
  670.       file transfer protocols they wish to support.
  671.  
  672.       A file called PROTOCOL.DAT is supplied with protocols already defined,
  673.       which you may alter at any time. Each entry in the PROTOCOL.DAT file
  674.       consists of the description that will be displayed to the caller on the
  675.       Protocol Menu and the 'high level' name of the protocol's batch files.
  676.  
  677.                Example:  ZModem   Upload or Download, ZPROT
  678.  
  679.       The information to the left of the comma is the description. Classified
  680.       requires that you have 2 batch files in the Classified directory to handle
  681.       the uploading and downloading. In the above example ZPROT is the 'high
  682.       level' portion of the 2 batch file names required for ZMODEM. Your
  683.       Classified directory should contain ZPROTR.BAT (the R is for uploading)
  684.       and ZPROTS.BAT (the S is for downloading). The R and S suffixes MUST be
  685.       present as that is what Classified Ads will be looking for in the
  686.       Classified Ad directory!
  687.  
  688.       Each protocol batch file MUST contain 2 batch file variables as follows:
  689.  
  690.       %1 = Classified will use this variable to substitute the current ComPort
  691.       %2 = Classified will use this variable to substitute the file name
  692.  
  693.       IMPORTANT! Place the variable (%1 and %2) ONLY in the EXACT location that
  694.                  your protocol requires them, in the protocol command line. Do
  695.                  NOT supply the ComPort or FileName, JUST the %1 and %2
  696.                  variables themselves (%1 and %2)!
  697.  
  698.       See example batch files supplied with the Classified. They are the ones
  699.       being used on the Sunrise-80 BBS.
  700.  
  701.                              *** PLEASE NOTE ***
  702.  
  703.       There may come a time when you will need to supply information to the
  704.       protocol you are using, based on the node it will be used on. You can
  705.       accomplish this by supplying a node-specific PROTOCOL file. Everything
  706.       described above stays the same except that you will name the file
  707.       PROTOCOL.x (where x is the node number). For example, to use a special
  708.       set of protocols (or batch files) on node number 5, modify a copy of
  709.       PROTOCOL.DAT and name it PROTOCOL.5. CLASSIFY will use PROTOCOL.5 when
  710.       someone logs on node 5 and will use PROTOCOL.DAT for ALL OTHERS. You do
  711.       not have to create node-specific PROTOCOL files for all nodes.. just the
  712.       node(s) that are different.
  713.  
  714.  
  715.  
  716.  
  717.  
  718.  
  719.  
  720.  
  721.  
  722.  
  723.  
  724.                                                                        Page 18
  725.  
  726.                     FILE COMPRESSION (COMPRESS.DAT)
  727.                     -------------------------------
  728.  
  729.    When a caller chooses to download a file of any kind, from Classified Ads,
  730.    they are presented with a list of compression types from which to choose.
  731.  
  732.    A file called COMPRESS.DAT is supplied with several types already defined.
  733.    You are free to alter the file to reflect the ones you support. Each entry
  734.    in the COMPRESS.DAT file consists of the description that will be displayed
  735.    to the caller on the Compression Menu, the name of the compression file
  736.    name and the command used to add files to the archive.
  737.  
  738.      EXAMPLE:
  739.                  PKZip  v1.10,PKZIP -a
  740.                  ARJ    v2.3,ARJ a
  741.  
  742.  
  743.    Please note that everything to the left of the comma is part of the
  744.    description for that compression type and may be modified to your liking.
  745.  
  746.  
  747.                                                                        Page 19
  748.  
  749.                      LIMITING EXPORTS BY CATEGORY
  750.                      ----------------------------
  751.  
  752.    By default the CLEXCH (Classified Exchange) program will export ads in ALL
  753.    categories. If you wish to limit the categories that will be exported,
  754.    create an ASCII file and call it CLEXPORT.CAT and enter the category
  755.    number(s) you DO NOT want to export, ONE to a line. The category number is
  756.    the line position of the category as it exists in the CLASSIFY.CAT file.
  757.  
  758.    For example, if the CLASSIFY.CAT file contained:
  759.  
  760.              Local For Sale
  761.              National For Sale
  762.              Local Announcements
  763.              National Announcements
  764.  
  765.    and you did NOT want to export local categories, you would create
  766.    CLEXPORT.CAT and input the following in the file:
  767.  
  768.    1
  769.    3
  770.  
  771.    Those 2 entries in the CLEXPORT.CAT would tell CLEXCH to NOT export the
  772.    "Local For Sale" and "Local Announcements" categories.
  773.  
  774.  
  775.                                                                        Page 20
  776.  
  777.                     MAINTENANCE PROGRAM (CLMAINT)
  778.                     -----------------------------
  779.  
  780.    The Classified Ads Maintenance program, CLMAINT.EXE, is a menu driven
  781.    program used to perform the following functions:
  782.  
  783.    (1) Maintain the PREPAID Ads file
  784.        . Add/view/delete prepaid ads entries in the PREPAID file
  785.  
  786.    (2) Database PURGE
  787.        .Will purge Ads, Messages and Prepaid Ads entries from their
  788.         respective files if they are marked for deletion.
  789.  
  790.    (3) View/maintain the Invisible Paid ads
  791.        .When an ad is entered into a PAID category, it is made invisible
  792.         (not displayable) until you manually make it visible. This option
  793.         allows you to do this or you can view and/or delete it
  794.  
  795.    (4) Setup the Classified Ads configuraiton file
  796.        .Use this option to setup or modify a configuration file.
  797.  
  798.    (5) Reset the EXPORT flag of ALL Ads in the database
  799.        .Use this option to force ALL ads in the Ads database to be marked for
  800.         Export the next time you run CLEXCH.
  801.  
  802.    (6) Reset the EXPORT flag of ALL Messages in the database
  803.        .Use this option to force ALL messages in the Message database to be
  804.         marked for Export the next time you run CLEXCH.
  805.  
  806.  
  807.    Execution examples:
  808.  
  809.       CLMAINT CLASSIFY.CFG               <===== Manual
  810.  
  811.              or
  812.  
  813.       CLMAINT CLASSIFY.CFG /EVENT        <===== Auto purge from an Event
  814.  
  815.                                                                        Page 21
  816.  
  817.                            PRE-PAID ADS
  818.                            ------------
  819.  
  820.    This option will allow you to accept payment for ads in advance. Using the
  821.    PREPAID ads option in the maintenance program (CLMAINT.EXE), you can add,
  822.    view or delete entries in the PREPAID file. The PREPAID file will contain
  823.    the name of the caller, the Ad display time (Week/Month/Quarter/Year) and
  824.    the number of ads they have prepaid for that type of Ad.
  825.  
  826.    You must have a separate entry for each display time type for each caller.
  827.    For example, a caller named Joe Door can prepay for 2 Monthly Ads and 3
  828.    Weekly Ads. In this case you would need 2 Joie Door entries in the PREPAID
  829.    file, one for the WEEKLY Ads and 1 for the Monthly Ads.
  830.  
  831.    When the caller enters an Ad in a PAY category, Classify asks what length
  832.    of time the Ad should run. If the program finds a match in the PREPAID file,
  833.    (on caller name and display time) it will make the Ad VISIBLE, IMMEDIATELY
  834.    and decrement the number of Pre-Paid Ads by 1.
  835.  
  836.    When the Purge option in CLMAINT is run (Manually or as an Event) entries
  837.    in the PREPAID file with a zero in the number of ads filed, will be deleted.
  838.  
  839.  
  840.    
  841.                                                                        Page 22
  842.                               LEGALITIES
  843.                               __________
  844.  
  845.  
  846.       THIS SOFTWARE AND ACCOMPANYING MATERIALS ARE DISTRIBUTED "AS IS"
  847.       WITHOUT WARRANTY, EXPRESS, IMPLIED OR STATUTORY, INCLUDING BUT NOT
  848.       LIMITED TO ANY IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS
  849.       FOR A PARTICULAR PURPOSE. IN NO EVENT SHALL ANYONE INVOLVED WITH
  850.       THE CREATION AND PRODUCTION OF THIS PRODUCT BE LIABLE FOR INDIRECT,
  851.       SPECIAL, OR CONSEQUENTIAL DAMAGES, ARISING OUT OF ANY USE THEREOF
  852.       OR BREACH OF ANY WARRANTY.
  853.  
  854.  
  855.  
  856.  
  857.  
  858.  
  859.  
  860.                              DISTRIBUTION
  861.                              ____________
  862.  
  863.    You may make this file available for downloading from your BBS or you may
  864.    upload it to any BBS of your choice, provided that you do not make any
  865.    changes to the contents of the archive (ZIP file). The archive and its
  866.    individual contents may not be used by any service that charges any money
  867.    whatsoever, without the written permission of the author.
  868.  
  869.  
  870.  
  871.  
  872.  
  873.  
  874.  
  875.  
  876.                              REGISTRATION
  877.                              ____________
  878.  
  879.    Registration and the subsequent insertion of the registration number into
  880.    your configuation file, will remove all restrictions deined in the section
  881.    called "Restrictions', allows for the display of your BBS name on the
  882.    opening and closing screen
  883.  
  884.    To register your copy of CLASSIFY, please fill out the registration form
  885.    (REGISTER.FRM) and mail it along with the registration fee to
  886.    the name and address on the form.
  887.  
  888.    Be sure to use the proper upper/lower case when filling in your name and
  889.    BBS name, as they MUST match the way you entered them in the configuration
  890.    file.             ^^^^
  891.  
  892.    Based upon information supplied on the registration form, I will pre-
  893.    register you on my BBS. You will then be able to call SUNRISE-80 and pick
  894.    up your registration number OR you can enclose a SASE with the form/check.
  895.  
  896.  
  897.  
  898.                                                                        Page 23
  899.                                  MISC
  900.                                  ____
  901.  
  902.    The latest version of CLASSIFIED ADS and other fine SUNRISE DOOR programs
  903.    are always available for download from SUNRISE-80 BBS.
  904.  
  905.    Remember, should you have any problems, questions or suggestions, be sure
  906.    to drop me a message on Sunrise-80 or in the RIME network (BBS_Doors,
  907.    PCBHints, SYSops) or on SMARTNET (SN_Sysops) or FIDO 1:133/410.
  908.